.TH E1432_SET_OCTAVE_AVG_MODE 3 E1432
.SH NAME
.nf
e1432_set_octave_avg_mode \- Set Octave measurement mode
e1432_get_octave_avg_mode \- Get Octave measurement mode
.IX e1432_set_octave_avg_mode(3) 3
.IX e1432_get_octave_avg_mode(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_octave_avg_mode(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 octave_avg_mode)
SHORTSIZ16 e1432_get_octave_avg_mode(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 *octave_avg_mode)
.cE
.SH DESCRIPTION

\fIe1432_set_octave_avg_mode\fR sets the octave average mode
of the modules(s) selected to the value given in \fIoctave_avg_mode\fR.

\fIe1432_get_octave_avg_mode\fR returns the octave mode state of the modules(s)
selected into a memory location pointed to by \fIoctave_avg_mode\fR.

This parameter is a "global" parameter.  It applies to an entire
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.
It is used to determine which module(s) in \fIhw\fR to set/query.

\fIoctave_avg_mode\fR must be one of
\fBE1432_OCTAVE_AVG_MODE_EXP\fR, which selects exponential averaging,
or \fBE1432_OCTAVE_AVG_MODE_LIN\fR, which selects linear (block) averaging.

\fBNote:\fR If octave_avg_mode is set to exponential, and the measurement
arm mode is set to time arm or rpm arm, the first trigger will start the 
measurement and all additional triggers will be ignored.

.SH "RESET VALUE"
After a reset, \fIoctave_avg_mode\fR is set to \fBE1432_OCTAVE_AVG_MODE_EXP\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_octave_mode,
e1432_set_octave_hold_mode,
e1432_set_octave_start_freq, e1432_set_octave_stop_freq,
e1432_set_octave_int_time,
e1432_set_octave_time_const,
e1432_set_octave_time_step,
e1432_octave_ctl,
e1432_get_octave_blocksize,
e1432_get_current_data
.ad
